home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 001 / qmodmous.arc / QMODMOUS.DOC < prev   
Text File  |  1986-03-10  |  9KB  |  265 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                Mouse Menus for QMODEM
  8.             
  9.                                    Mark F. Lewis
  10.                                     07-Mar-1986
  11.             
  12.             I. Introduction
  13.             
  14.                  QMODMOUS.ARC contains  menu definition  files  for  use
  15.                  with QMODEM  V2.0  and  either  a  Microsoft  or  Mouse
  16.                  Systems Mouse.   Three  sample menu files are provided.
  17.                  These are:
  18.                  
  19.                            QMODEMU.DEF
  20.                            QMODEMPB.DEF
  21.                            M_QMODEM.MSC
  22.                  
  23.                  The first two are menu definition files for Microsoft's
  24.                  MAKEMENU utility  and MENU.COM program.  The third is a
  25.                  menu definition  for Mouse  Systems'  MSC  utility  and
  26.                  MOUSESYS.COM program.
  27.                  
  28.                  Because Microsoft  menu's are  inherently more flexible
  29.                  than those  of Mouse Systems, the menu definition files
  30.                  are more  ambitious.   Users with  Mouse Systems' mouse
  31.                  should be  aware that  Microsoft's menu  software  will
  32.                  execute  with   the  Mouse   Systems  mouse   via   the
  33.                  MSMOUSE.SYS or  MSMOUSE.COM programs.    Getting  one's
  34.                  hands on  the Microsoft  software is another matter; it
  35.                  appears that  Microsoft does not sell the menu software
  36.                  except as part of the Microsoft mouse hardware kit.
  37.                  
  38.                  
  39.             II. Menus for use with Microsoft Makemenu & Menu Utilities.
  40.             
  41.                  Two  menus   are  supplied  for  use  with  Microsoft's
  42.                  utilities:  QMODEMU.DEF, which limits it's functions to
  43.                  QMODEM  internal  functions,  and  QMODEMPB.DEF,  which
  44.                  expands it's functions to include main menu support for
  45.                  PCBOARD  BBSs.     The   latter  was   written  as   an
  46.                  illustration of  the mouse  menus may  be  expanded  to
  47.                  support  those   remote  services  you  use  the  most.
  48.                  PCBOARD software  was selected  only  because  PCBOARDs
  49.                  seem to  be the most consistent from version-to-version
  50.                  and from BBS-to-BBS.
  51.                  
  52.                  
  53.                  1. QMODEMU.DEF
  54.                  
  55.                       To use  QMODEMU.DEF you must first compile it with
  56.                       Microsoft's    Makemenu    utility    to    create
  57.                       QMODEMU.MNU.   Before doing  so you should examine
  58.                       the code  within QMODEMU.DEF.   There  are several
  59.                       MATCH statements  that may not work with QMODEM as
  60.                       you've installed  it.    QMODEMU.DEF  expects  all
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.                       QMODEM windows  to be  in their default locations.
  74.                       If you  have used  QINSTALL to  move any  of these
  75.                       windows you  will have  to   edit the  appropriate
  76.                       MATCH statements  in QMODEMU.DEF or rerun QINSTALL
  77.                       to place  the  QMODEM  windows  at  their  default
  78.                       locations.
  79.                       
  80.                       Once you  have created  QMODEMU.MNU, you  may  use
  81.                       your mouse  with QMODEM by executing the following
  82.                       commands:
  83.                       
  84.                            MENU QMODEMU
  85.                            QMODEM
  86.                       
  87.                       After QMODEM  exits you  should turn off the mouse
  88.                       menu via:
  89.                       
  90.                            MENU OFF
  91.                       
  92.                       
  93.                  2. QMODEMPB.DEF
  94.                  
  95.                       QMODEMPB is  a superset  of QMODEMU.DEF.   Do  not
  96.                       attempt to  use QMODEMPB  until you  have  QMODEMU
  97.                       working properly.   If  you had to make changes to
  98.                       the QMODEMU  MATCH statements,  you will  have  to
  99.                       make identical changes to QMODEMPB.DEF.
  100.                       
  101.                       Again,  compile   QMODEMPB.DEF  using  Microsoft's
  102.                       Makemenu utility  to create QMODEMPB.MNU.  Execute
  103.                       QMODEM via  the following  commands to  get  mouse
  104.                       menu control:
  105.                       
  106.                            MENU QMODEMPB
  107.                            QMODEM
  108.                       
  109.                       As with  QMODEMU, you  should execute  a MENU  OFF
  110.                       command after you finish running QMODEM.
  111.                       
  112.                       QMODEMPB   contains   several   match   statements
  113.                       designed to catch PCBOARD's Main Menu.  If you get
  114.                       the QMODEM  menu instead when you're logged onto a
  115.                       PCBOARD and at the Main Menu prompt then there are
  116.                       three possible reasons for the mouse menu failure:
  117.                        1.  the  menu  prompt  on  that  board  has  been
  118.                          modified  to  be  non-standard.  In  this  case
  119.                          you'll have  to edit  the  QMODEMPB  source  to
  120.                          accommodate that  board or  just  use  keyboard
  121.                          commands with that board.
  122.                        2. you  are joined to a conference on that board.
  123.                          Again, you  may either edit the QMODEMPB source
  124.                          to provide  MATCH statements  tailored to  that
  125.                          prompt, or just use keyboard commands.
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.                        3. you  have graphics  mode enabled.   To use the
  140.                          mouse  menu   you'll  have   to  disable   ANSI
  141.                          Graphics.
  142.                       
  143.                       If the  mouse menu  does come  up  correctly,  the
  144.                       first thing  you should  do is turn the Xpert mode
  145.                       toggle on.   This  will save  you  from  the  time
  146.                       wasted having the menu retyped frequently.
  147.                       
  148.                       
  149.                  3. Rolling your own.
  150.                  
  151.                       Use either  QMODEMU.DEF or  QMODEMPB.DEF as models
  152.                       for creating  customized mouse  menus for use with
  153.                       QMODEM.     QMODEMPB.DEF  shows  you  three  MATCH
  154.                       statements all  designed to  recognize the PCBOARD
  155.                       main menu command, which varies in screen location
  156.                       depending  upon   the  amount   of  connect   time
  157.                       remaining.   For  many  services  a  single  MATCH
  158.                       statement is  all that's required to recognize the
  159.                       menu prompt.   Additional  MATCH statements may be
  160.                       added for subsidiary menus within the same service
  161.                       or for additional services.
  162.                       
  163.                       NOTE:   Early editions of Microsoft's MENU utility
  164.                       limited the  user to  MNU files  less than  6K  in
  165.                       size.   The current  QMODEMPB.DEF compiles to 6400
  166.                       bytes.   It may  not work with your version of the
  167.                       MENU program.
  168.                       
  169.                       
  170.             III. Menu for use with Mouse Systems' MSC utility.
  171.             
  172.             
  173.                  M_QMODEM.MSC  is   a  menu  definition  file  that  may
  174.                  compiled with  Mouse System's  MSC utility to produce a
  175.                  simple mouse  menu for  use with  QMODEM.   Because the
  176.                  Mouse Systems  software provides  less  flexibility  in
  177.                  menu construction  (i.e., no  multi-column menus and no
  178.                  ability to  branch based  on screen content), the menus
  179.                  defined in M_QMODEM.MSC are much less ambitious.  It is
  180.                  possible to  expand on  these menus'  functionality  by
  181.                  creating additional  submenus; if you're limited to the
  182.                  Mouse Systems software you might find that a profitable
  183.                  exercise.
  184.                  
  185.                  To use M_QMODEM.MSC, first run the MSC compiler:
  186.                  
  187.                       MSC M_QMODEM.MSC
  188.                  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.                  To use  mouse menus  with QMODEM, execute the following
  206.                  commands:
  207.                  
  208.                       MOUSESYS  with appropriate switches.
  209.                       M_QMODEM
  210.                       QMODEM
  211.                  
  212.                  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.